<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>hostnamectl
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>hostnamectl 中文手册</h1><h2 id="auth_name">译者：<strong><a href="../index.html">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="../index.html">金步国作品集</a> [ <a href="../index.html">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="hostnamectl"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>hostnamectl — 控制系统的主机名</p></div><div class="refsynopsisdiv"><h2>大纲</h2><div class="cmdsynopsis"><p><code class="command">hostnamectl</code>  [OPTIONS...] {COMMAND}</p></div></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="hostnamectl.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p><span class="command"><strong>hostnamectl</strong></span> 可用于查询与修改系统主机名以及其他相关设置。
    所谓"主机名"，其实有三种不同的含义：</p><p>"pretty"主机名，
    仅供人类阅读，可以包含各种特殊字符，且无长度限制。
    例如"Lennart's Laptop"(必须是UTF-8编码)。
    pretty(易读主机名)、chassis(设备类型)、icon(图标名称)存储在
    <code class="filename">/etc/machine-info</code> 文件中，
    详见
    <a href="machine-info.html#"><span class="citerefentry"><span class="refentrytitle">machine-info</span>(5)</span></a>
    手册。</p><p>"static"主机名，用于在系统启动时设置内核的主机名，仅可包含 "-","a-z","0-9" 字符，且最大不超过64个字符长度。
    例如"lennarts-laptop"。此种主机名就是通常所说的"主机名"，存储在 <code class="filename">/etc/hostname</code> 文件中，
    详见 <a href="hostname.html#"><span class="citerefentry"><span class="refentrytitle">hostname</span>(5)</span></a> 手册。</p><p>"transient"主机名，
    是从网络配置中获得的 fallback 主机名，
    同样仅可包含 "-","a-z","0-9" 字符，
    且最大不超过64个字符长度。
    如果存在"static"主机名且不等于"localhost"，
    那么将忽略"transient"主机名。</p><p>可以使用
    <a href="systemd-firstboot.html#"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
    初始化已挂载(但未启动)的系统镜像的
    主机名(hostname)。</p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项(OPTIONS)">选项(OPTIONS)<a class="headerlink" title="Permalink to this headline" href="hostnamectl.html#%E9%80%89%E9%A1%B9(OPTIONS)">¶</a></h2><p>能够识别的命令行选项如下：</p><div class="variablelist"><dl class="variablelist"><dt id="--no-ask-password"><span class="term"><code class="option">--no-ask-password</code></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#--no-ask-password">¶</a></dt><dd><p>在执行特权操作时
        不向用户索要密码。</p></dd><dt id="--static"><span class="term"><code class="option">--static</code>, </span><span class="term"><code class="option">--transient</code>, </span><span class="term"><code class="option">--pretty</code></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#--static">¶</a></dt><dd><p>与默认的 <span class="command"><strong>status</strong></span> 命令一起使用，
        表示仅显示特定的主机名(不可同时使用多个选项)。</p><p>与 <span class="command"><strong>set-hostname</strong></span> 命令一起使用，
        表示仅更新特定的主机名(可以同时使用多个选项)。</p></dd><dt id="-H"><span class="term"><code class="option">-H</code>, </span><span class="term"><code class="option">--host=</code></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#-H">¶</a></dt><dd><p><a name="host-text"></a>操作指定的远程主机。可以仅指定一个主机名(hostname)，
      也可以使用 "<code class="literal">username@hostname</code>" 格式。
      hostname 后面还可以加上
      SSH监听端口(以冒号"<code class="literal">:</code>"分隔)与容器名(以正斜线"<code class="literal">/</code>"分隔)，
      也就是形如 "<code class="literal">hostname:port/container</code>" 的格式，
      以表示直接连接到指定主机的指定容器内。
      操作将通过SSH协议进行，以确保安全。
      可以通过
      <span class="command"><strong>machinectl -H
      <em class="replaceable"><code>HOST</code></em></strong></span> 命令列出远程主机上的所有容器名称。IPv6地址必须放在方括号([])内。</p></dd><dt id="-M"><span class="term"><code class="option">-M</code>, </span><span class="term"><code class="option">--machine=</code></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#-M">¶</a></dt><dd><p><a name="machine-text"></a>在本地容器内执行操作。
      必须明确指定容器的名称。</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#-h">¶</a></dt><dd><p><a name="help-text"></a>显示简短的帮助信息并退出。
    </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#--version">¶</a></dt><dd><p><a name="version-text"></a>显示简短的版本信息并退出。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="命令(COMMAND)">命令(COMMAND)<a class="headerlink" title="Permalink to this headline" href="hostnamectl.html#%E5%91%BD%E4%BB%A4(COMMAND)">¶</a></h2><p>能够识别的命令如下：</p><div class="variablelist"><dl class="variablelist"><dt id="status"><span class="term"><span class="command"><strong>status</strong></span></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#status">¶</a></dt><dd><p>显示当前的主机名及其他相关信息。
        如果未指定任何命令，那么这是隐含的默认命令。</p></dd><dt id="set-hostname NAME"><span class="term"><span class="command"><strong>set-hostname <em class="replaceable"><code>NAME</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#set-hostname%20NAME">¶</a></dt><dd><p>将系统的主机名设为 <em class="replaceable"><code>NAME</code></em> 。
        如果使用了 <code class="option">--static</code>, <code class="option">--transient</code>, <code class="option">--pretty</code> 选项，
        那么只更新指定的主机名，否则同时更新 pretty, static, transient 三个主机名。
        如果在设置 pretty 主机名的同时也设置 static/transient 主机名，
        那么 static/transient 主机名将根据如下规则从 pretty 主机名派生而来：
        首先将大写字母转换为小写字母，然后删除不在"-","a-z","0-9"范围内的字符。
        这样可以确保 static/transient 主机名始终保持与 pretty 主机名一致，同时又不违反自身的命名规则。
        如果仅设置 static/transient 主机名，则不会对 pretty 主机名产生任何影响。</p><p>注意，若设为空字符串，
        则表示
        将主机名重置为默认值(通常是 "<code class="literal">localhost</code>")。</p></dd><dt id="set-icon-name NAME"><span class="term"><span class="command"><strong>set-icon-name <em class="replaceable"><code>NAME</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#set-icon-name%20NAME">¶</a></dt><dd><p>将系统的图标名设为
        <em class="replaceable"><code>NAME</code></em> ，
        某些图形界面的应用程序会根据此设置给主机配上适当的图标。
        此名称必须遵守 <a class="ulink" href="https://standards.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html" target="_top">
        图标命名规范</a>。</p><p>注意，若设为空字符串，
        则表示将图标名重置为
        默认值(通常由"设备类型"决定)。</p></dd><dt id="set-chassis TYPE"><span class="term"><span class="command"><strong>set-chassis <em class="replaceable"><code>TYPE</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#set-chassis%20TYPE">¶</a></dt><dd><p>将系统的设备类型
        设为
        <em class="replaceable"><code>TYPE</code></em>，
        某些图形界面的应用程序
        会根据此设置切换到合适的人机界面之类。
        取值范围如下：
        "<code class="literal">desktop</code>"(台式机),
        "<code class="literal">laptop</code>"(笔记本),
        "<code class="literal">convertible</code>"(折叠本),
        "<code class="literal">server</code>"(服务器),
        "<code class="literal">tablet</code>"(平板电脑),
        "<code class="literal">handset</code>"(智能手机),
        "<code class="literal">watch</code>"(智能手表),
        "<code class="literal">embedded</code>"(嵌入式设备),
        "<code class="literal">vm</code>"(虚拟机),
        "<code class="literal">container</code>"(容器)
        。</p><p>注意，若设为空字符串，
        则表示
        将设备类型重置为默认值(通常由主板固件决定)。</p></dd><dt id="set-deployment ENVIRONMENT"><span class="term"><span class="command"><strong>set-deployment <em class="replaceable"><code>ENVIRONMENT</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#set-deployment%20ENVIRONMENT">¶</a></dt><dd><p>将系统的部署环境设为
        <em class="replaceable"><code>ENVIRONMENT</code></em> 。
        必须设为一个单独的单词且禁止包含任何特殊字符。
        建议设为下列单词中的一个：
        "<code class="literal">development</code>"(开发),
        "<code class="literal">integration</code>"(综合),
        "<code class="literal">staging</code>"(阶段),
        "<code class="literal">production</code>"(生产)
        </p><p>注意，若设为空字符串，
        则表示将部署环境重置为默认值(同样是空字符串)。</p></dd><dt id="set-location LOCATION"><span class="term"><span class="command"><strong>set-location <em class="replaceable"><code>LOCATION</code></em></strong></span></span><a class="headerlink" title="Permalink to this term" href="hostnamectl.html#set-location%20LOCATION">¶</a></dt><dd><p>将系统的地理位置
        设为 <em class="replaceable"><code>LOCATION</code></em> 。
        必须设为一个人类易读字符串，
        准确的描述出主机所在的物理位置。
        例如：
        "<code class="literal">XX数据中心3楼E23机柜U7</code>"</p><p>注意，若设为空字符串，
        则表示将地理位置重置为默认值(同样是空字符串)。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.8"></a><h2 id="退出状态">退出状态<a class="headerlink" title="Permalink to this headline" href="hostnamectl.html#%E9%80%80%E5%87%BA%E7%8A%B6%E6%80%81">¶</a></h2><p>返回值为 0 表示成功，
    非零返回值表示失败代码。</p></div><div class="refsect1"><a name="id-1.9"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="hostnamectl.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
      <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
      <a href="hostname.html#"><span class="citerefentry"><span class="refentrytitle">hostname</span>(1)</span></a>,
      <a href="hostname.html#"><span class="citerefentry"><span class="refentrytitle">hostname</span>(5)</span></a>,
      <a href="machine-info.html#"><span class="citerefentry"><span class="refentrytitle">machine-info</span>(5)</span></a>,
      <a href="systemctl.html#"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
      <a href="systemd-hostnamed.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-hostnamed.service</span>(8)</span></a>,
      <a href="systemd-firstboot.html#"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
    </p></div></div></body></html>
